feat: adding gh changelog/releases to npmx by WilcoSp · Pull Request #1233 · npmx-dev/npmx.dev

WilcoSp · 2026-02-08T20:02:42Z

This pr will add the possibility to view the changelog.md & releases from a package's github repo within npmx.
This will make it easier to see the changelogs while not needing to leave npmx and allowing quicker access.

This pr is the first pr of #501

Preview here, this will automatically update

Acknowledgements

While I was making this PR antfu also made this pr #1368 and here my comment from his pr

Also @ShroXd is currently working on adding changelogs to the version history page that was merged with #2025, we've both agreed to first independently work on our PRs and later after both are merged and we've received feedback & irl use we'll collaborate on the interaction between the two

Translations

Thanks @WarningImHack3r for translating the text for changelog to French
I've also added Dutch translations

…md -> html does need to change)

…eat/changelog-1

vercel · 2026-02-08T20:02:50Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
npmx.dev	Ready	Preview, Comment	May 10, 2026 3:53pm

2 Skipped Deployments

Project	Deployment	Actions	Updated (UTC)
docs.npmx.dev	Ignored	Preview	May 10, 2026 3:53pm
npmx-lunaria	Ignored		May 10, 2026 3:53pm

github-actions · 2026-02-08T20:03:24Z

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File	Note
i18n/locales/en.json	Source changed, localizations will be marked as outdated.
i18n/locales/fr-FR.json	Localization changed, will be marked as complete. 🔄️
i18n/locales/kn-IN.json	Localization changed, will be marked as complete. 🔄️
i18n/locales/nl.json	Localization changed, will be marked as complete. 🔄️
i18n/locales/tr-TR.json	Localization changed, will be marked as complete. 🔄️

Warnings reference

Icon	Description
🔄️	The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

codecov · 2026-02-08T20:04:29Z

Codecov Report

❌ Patch coverage is 63.07692% with 24 lines in your changes missing coverage. Please review.
✅ All tests successful. No failed tests found.

Files with missing lines	Patch %	Lines
app/components/Changelog/Card.vue	63.15%	7 Missing ⚠️
app/components/Package/Header.vue	41.66%	7 Missing ⚠️
app/utils/router.ts	0.00%	3 Missing and 2 partials ⚠️
...pp/composables/useCommandPalettePackageCommands.ts	72.72%	3 Missing ⚠️
app/pages/settings.vue	0.00%	1 Missing and 1 partial ⚠️

📢 Thoughts on this report? Let us know!

excludes changelog releases due to needing api calls

…nged

…eat/changelog-1

43081j · 2026-04-29T09:25:18Z

left one minor comment but this generally looks good to me.

i think we need to move this on as its been continuously reviewed since Feb.

what'd be helpful:

another review from a maintainer, particularly of the general UX and the markdown logic
do any significant changes in follow up PRs unless they're truly a blocker here

WilcoSp · 2026-04-29T14:02:37Z

for further significant changes I've already made a new branch (compare pr), the pr will be made after this pr gets merged.

I do hope that this pr can be merged soon because there are further plans.

43081j

approving but please hold off merging until we get another approval as this is a big one.

gameroman

Very good overall 🎉

One thing I noticed is there doesn't seem to be any loading indicator when opening the changelog page for the first time, but this can be done in the next PR

WilcoSp · 2026-04-30T08:33:03Z

Yeah the skeletons loaders can be improved, currently they're only being shown when fetching data but not during server rendering of the changelog components due to not accounting for ssr.

gameroman · 2026-05-05T10:47:23Z

@ghostdevv @serhalp @alexdln could you re-review this please, thanks!

serhalp · 2026-05-09T02:22:02Z

(not blockers, we should merge and follow up!)

There's something buggy going on with the header nav items (two different bugs). Check it out:

npmx.pr.1233.bug.1.mp4

Is it known that for some monorepo patterns it shows all monorepo packages releases rather than just that package? e.g. https://npmxdev-git-fork-wilcosp-feat-changelog-1-npmx.vercel.app/package-changelog/@netlify/blobs/v/10.7.4
We really should have each heading have some way to link to the canonical changelog/release (heading). It feels very natural to be be able to jump like that but currently you can only scroll to the top of the page and click the global canonical link.

Thank you so much for all your work on this! It's been a hell of a long road. 🙏🏼 This is going to be a killer feature!

serhalp

🚀

serhalp · 2026-05-09T02:24:07Z

Are these because we don't have a working strategy yet for i18n strings in server → browser error messages? 🤔

yes, these were even made before the discussion of having i18n strings on the server side.

serhalp · 2026-05-09T02:26:16Z

+  'Changelog/Releases.vue': 'Requires API calls',
+  'Changelog/Markdown.vue': 'Requires API call & only renders markdown html',


requiring API calls isn't strictly a blocker here, is it? many components do 🤔

apart from requiring api calls, both components do also mostly render html from the markdown renderer.
so an a11y test would mostly test things that the components doesn't have influence over.

if you know a way to test these components, I'm open to implement the tests

serhalp · 2026-05-09T02:34:55Z

+    if (!release.publishedAt) {
+      return
+    }
+    return requestedDate === toIsoDate(new Date(release.publishedAt))


nit: is this redundant or am I missing something? 🤔

Suggested change

return requestedDate === toIsoDate(new Date(release.publishedAt))

return requestedDate === release.publishedAt

the string -> date -> string isn't needed, I've now implemented that the date is now sliced out of the full iso date+time string

serhalp · 2026-05-09T02:36:55Z

+      const uChangelog = changelog.value
+      if (uChangelog?.type === 'md' || uChangelog?.type === 'release') {


nit: this seems smelly to me? seems like there should be some sort of abstraction here like shouldShowChangelog or hasValidChangelog or whatever

I've just moved this to composables for both packageHeader & command palette.
for command palette it does use useState because of the buggy behavior I commented on earlier, the state is provided by the package header component
WilcoSp@e3bafc5

WilcoSp · 2026-05-10T15:47:43Z

There's something buggy going on with the header nav items (two different bugs).

I've looked into what causes "no changelog available".
it happens in the command pallet package commands composable when no package name is available yet, this messes things up with useLazyFetch, I'll try to fix this in the mdkit branch but it'll take some time.

for the not navigating I think it's partly caused by ^^ because when no package name is known yet currently "data;text/json,null" is given as url to return null, but the mime type should be "application" instead of "text".
edit: I just fixed the typo right after fixing the merge conflicts caused by timeline being added to the command pallet

Is it known that for some monorepo patterns it shows all monorepo packages releases rather than just that package

yes I know about it, for now all releases are shown unfiltered but I do want to filter these in the future for monorepos, only issue is that everyone does it a bit different, some

We really should have each heading have some way to link to the canonical changelog/release (heading). It feels very natural to be be able to jump like that but currently you can only scroll to the top of the page and click the global canonical link.

if you let me know how, I'll be happy to add it.

serhalp · 2026-05-11T12:28:48Z

@WilcoSp Thank you for all your work and persistence on this! I know it's been a long road. I'm going to merge it now. It will be on main.npmx.dev, where we can iterate on the follow-ups! 🚀

WilcoSp and others added 9 commits February 4, 2026 21:17

now able to detect whether gh releases are biing used by a package.

c0a23b4

Merge branch 'npmx-dev:main' into feat/changelog-1

4873b1c

moved has changelog to it's own api endpoint

92193b5

added detection of a changelog file on the root of the github repo

2a397bf

Merge branch main into feat/changelog-1

4cfbbfe

Merge branch 'npmx-dev:main' into feat/changelog-1

42802dc

github releases are now being show at /package-changes (rendering of …

9c130bd

…md -> html does need to change)

Merge branch 'feat/changelog-1' of github.com:WilcoSp/npmx.dev into f…

a424459

…eat/changelog-1

Merge branch 'npmx-dev:main' into feat/changelog-1

e487292

vercel Bot deployed to Preview – docs.npmx.dev February 8, 2026 20:04 View deployment

vercel Bot deployed to Preview – npmx.dev February 8, 2026 20:04 View deployment

WilcoSp mentioned this pull request Feb 8, 2026

Discussion: changelogs button #501

Open

16 tasks

vinnymac mentioned this pull request Feb 9, 2026

feat: changelog button #766

Closed

antfu mentioned this pull request Feb 11, 2026

feat: link to releases #1368

Draft

4 tasks

Merge branch 'npmx-dev:main' into feat/changelog-1

6c7d817

vercel Bot deployed to Preview – docs.npmx.dev February 11, 2026 18:09 View deployment

vercel Bot deployed to Preview – npmx.dev February 11, 2026 18:09 View deployment

WilcoSp added 2 commits February 11, 2026 19:30

fixed issue where markdown from github releases could be null

ba81215

some refactoring

8d22cf2

vercel Bot deployed to Preview – npmx.dev February 11, 2026 20:53 View deployment

WilcoSp added 2 commits February 11, 2026 22:21

adding a11y test for changelog card.

f8b32d4

excludes changelog releases due to needing api calls

markdown is now being rendered (settings need to be added still)

b345df1

vercel Bot deployed to Preview – npmx.dev February 12, 2026 21:05 View deployment

Merge branch 'npmx-dev:main' into feat/changelog-1

f4c84ec

vercel Bot deployed to Preview – docs.npmx.dev February 12, 2026 21:09 View deployment

vercel Bot deployed to Preview – npmx.dev February 12, 2026 21:09 View deployment

added headings handling and toc (only scroll behavior needs to be cha…

bc0fa2f

…nged

WilcoSp and others added 11 commits April 20, 2026 09:57

Merge branch 'main' into feat/changelog-1

48938cc

Merge branch 'main' into feat/changelog-1

0dafd12

Merge branch 'feat/changelog-1' of github.com:WilcoSp/npmx.dev into f…

8d24e10

…eat/changelog-1

og image, fixed the title

3d1c449

fixed issue resolving relative urls

fe161e9

now correctly fixed resolving path

4d82191

Merge branch 'npmx-dev:main' into feat/changelog-1

31daed5

fixing resolving npmjs -> npmx urls

2726303

Merge branch 'feat/changelog-1' of github.com:WilcoSp/npmx.dev into f…

8a5eb66

…eat/changelog-1

..

2739315

Merge branch 'npmx-dev:main' into feat/changelog-1

fdb0c9f

43081j reviewed Apr 29, 2026

View reviewed changes

Comment thread server/api/changelog/info/[name]/v/latest.get.ts

43081j approved these changes Apr 29, 2026

View reviewed changes

gameroman approved these changes Apr 29, 2026

View reviewed changes

WilcoSp added 2 commits May 3, 2026 16:43

Merge branch 'main' into feat/changelog-1

48a9f4e

Merge branch 'npmx-dev:main' into feat/changelog-1

771aa74

serhalp approved these changes May 9, 2026

View reviewed changes

WilcoSp and others added 2 commits May 9, 2026 10:41

Merge branch 'main' into feat/changelog-1

ed22222

fix remove whatsapp og image

727dbae

WilcoSp added 2 commits May 10, 2026 17:50

Merge branch 'main' into feat/changelog-1

52cc1f9

fix type mime type json at usePackageChangelog

ccbac72

github-actions Bot mentioned this pull request May 11, 2026

chore: release v0.13.0 #2713

Open

WilcoSp mentioned this pull request May 11, 2026

refactor: combining shared code markdown renderer readme & changelog #2717

Open

		'Changelog/Releases.vue': 'Requires API calls',
		'Changelog/Markdown.vue': 'Requires API call & only renders markdown html',

	return requestedDate === toIsoDate(new Date(release.publishedAt))
	return requestedDate === release.publishedAt

		const uChangelog = changelog.value
		if (uChangelog?.type === 'md' \|\| uChangelog?.type === 'release') {

Uh oh!

Conversation

WilcoSp commented Feb 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Acknowledgements

Translations

Uh oh!

vercel Bot commented Feb 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Feb 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Lunaria Status Overview

Tracked Files

Uh oh!

codecov Bot commented Feb 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Uh oh!

43081j commented Apr 29, 2026

Uh oh!

WilcoSp commented Apr 29, 2026

Uh oh!

43081j left a comment

Choose a reason for hiding this comment

Uh oh!

gameroman left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

WilcoSp commented Apr 30, 2026

Uh oh!

gameroman commented May 5, 2026

Uh oh!

serhalp commented May 9, 2026

Uh oh!

serhalp left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

WilcoSp commented May 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

serhalp commented May 11, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

10 participants

WilcoSp commented Feb 8, 2026 •

edited

Loading

vercel Bot commented Feb 8, 2026 •

edited

Loading

github-actions Bot commented Feb 8, 2026 •

edited

Loading

codecov Bot commented Feb 8, 2026 •

edited

Loading

gameroman left a comment •

edited

Loading

WilcoSp commented May 10, 2026 •

edited

Loading